home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DESQVIEW / DVSI11.ARJ / MANPAGES.DOC < prev    next >
Text File  |  1991-08-11  |  21KB  |  613 lines
  1. NAME
  2.      df - free and used disk space
  3.  
  4. SYNOPSIS
  5.      df [/cn /r /p /?]
  6.  
  7. DESCRIPTION
  8.      DF reports on the disk space available all hard drives.  Its
  9.      output looks like this:
  10.  
  11.      Drive Label      Used  Available
  12.      C:    SYSTEM      57%      2096K
  13.      D:    OLDDRIVE    48%     10742K
  14.      E:    APPLICATNS  90%      1646K
  15.      F:    DATA        35%     13140K
  16.  
  17.      DF finds all drives, such as network drives, higher than C:
  18.      and includes them in the list.  With the /c option, DF will
  19.      dynamically watch the available drives.  If a SUBST command
  20.      is used or a network drive is added, DF will update its list
  21.      to include that drive.
  22.  
  23. OPTIONS
  24.      Options are case sensitive and may be strung together: /c4/r
  25.  
  26.      /cn
  27.      Continuously update the list every n seconds.  Normally, df
  28.      lists the disk space and exits.  This option is most useful when
  29.      df is used in its own window.  n must be an integer between
  30.      0 and 65535.  Hitting any key will stop the listing and
  31.      cause df to exit.
  32.  
  33.      /r
  34.      Resize the window to fit exactly the number of drives in the
  35.      system.  Useful with /c option.
  36.  
  37.      /p
  38.      Print "Press any key to continue..." and wait for keystroke
  39.      before exiting.
  40.  
  41.      /?
  42.      Display a help screen.
  43.  
  44. BUGS
  45.      If using /c and /r, the maximum size of the window must be
  46.      as large as the (max # of drives+1) or strange things will happen.
  47.  
  48. Last Updated: August 11, 1991
  49.  
  50. ----------------------------------------------------------------------------
  51.  
  52.  
  53. NAME
  54.      dvsixdi - External Device Interface for DVSI
  55.  
  56. SYNOPSIS
  57.      In autoexec.bat:
  58.  
  59.      [loadhi] dvsixdi.com
  60.  
  61. DESCRIPTION
  62.      DVSIXDI is the heart of DVSI.  It keeps track of the processes
  63.      that DESQview starts and stops, as well as the CPU time of each
  64.      process and other information.  Basically, whenever DESQview
  65.      does something important, it calls DVSIXDI to record what is
  66.      happening.
  67.  
  68.      DVSIXDI should be installed before DESQview is run.  It is
  69.      best to put it in AUTOEXEC.BAT.  It will take up about
  70.      1.2K of memory after it exits.  To minimize the memory it requires,
  71.      load it (and any other TSRs) before you set your PATH and
  72.      other environment variables.  Preferrably, it should be loaded
  73.      in high memory, but this is not required.
  74.  
  75.      DVSIXDI may error out and not load.  The possible error messages
  76.      are:
  77.  
  78.      Error: Already Installed
  79.           You can only load DVSIXDI once.
  80.  
  81.      Error: No available slots
  82.           You have too many TSRs loaded that use the Multiplex interrupt
  83.           2F.  DVSIXDI cannot be loaded until an interrupt 2F slot is
  84.           available.
  85.  
  86.      DVSIXDI requires at least version 2.26 of DESQview.
  87.  
  88.      Other programs can communicate with DVSIXDI.  Please read
  89.      the distribution information in README.1ST; I retain the
  90.      copyright for this material and I do not allow modification
  91.      of the DVSI package.
  92.  
  93.      I do not guarantee anything about the future of the DVSIXDI
  94.      interface except for the installation check and the version check.
  95.      The interface for version 1.10 is
  96.  
  97.      AX=0de01h  BX=7575h  CX=function
  98.  
  99.      Function
  100.      00h - Installation check
  101.            Returns AL=ffh if installed
  102.  
  103.      01h - Notification on: not currently used
  104.  
  105.      02h - Notification off: not currently used
  106.  
  107.      03h - Get application records
  108.            Return
  109.              CX = number of application records
  110.              ES:DI pointer to array of application records
  111.              AX = 1 if OK, 0 if not OK
  112.              BX = last instantaneous time slice in 1/100 secs
  113.  
  114.            ES:DI points to the data structure in use.  I recommend
  115.            that you start a critical section, make this call, make
  116.            a copy of the records, and end the critical section.  Only
  117.            those records that have (flags & 0x80) true are valid, but
  118.            there are 15 records total.
  119.  
  120.            Application record:
  121.            app_rec_t struc
  122.                    flags           db ?  ;See below
  123.                    openkeys        dw ?  ;Keys on Open Window menu
  124.                    appnum          dw ?  ;Switch windows #
  125.                    handle          dw ?  ;Segment of handle of process
  126.                    numtasks        dw ?  ;Number of tasks including self
  127.                    mapcntx         dw ?  ;Mapping context of process
  128.                    t_start         dd ?  ;DVSI clock value at process's start
  129.                    t_getcpu        dd ?  ;DVSI clock when last got CPU
  130.                    t_giveupcpu     dd ?  ;DVSI clock when last gave up CPU
  131.                    t_cpu           dd ?  ;CPU time in 1/100 sec since start
  132.                    t_cpu_last      dd ?  ;CPU time at instant. time start ago
  133.                    t_cpu_inst      dd ?  ;CPU time in last instant. time secs
  134.                    hook            dd ?  ;Hook for other programs
  135.            app_rec_t ends
  136.  
  137.                The flags field can be an ORing of:
  138.                    04h   ;This is DV system task
  139.                    80h   ;Valid record (used internally by DVSIXDI)
  140.                These flags are not currently used:
  141.                    01h   ;This task swapped out
  142.                    02h   ;This task has keyboard
  143.  
  144.                DVSI clock value of 0 is the time DESQview is started.
  145.                Clock values are in 1/100 seconds.
  146.  
  147.                The Instantaneous Time is approximately 10 seconds.  The
  148.                t_cpu_last field is the value of the t_cpu field before
  149.                the current Instantaneous Time period started.  The
  150.                t_cpu_inst field is the amount of cpu time in the last
  151.                Instantaneous Time period (t_cpu - t_cpu_last).
  152.  
  153.      04h - Get Version
  154.           Return AH=Major, AL=Minor (1.10 is 010Ah)
  155.  
  156.      05h - Get Time since DV started
  157.           Return DX:AX = 1/100 seconds since DV started
  158.  
  159.      06h - Get Task Switches
  160.           Return DX:AX = # of task switches since DV start
  161.                     CX = # of task switches in last instantaneous time
  162. BUGS
  163.      DVSIXDI only keeps track of 15 processes at a time. Anything
  164.      started after 15 is ignored completely, and never seen again
  165.      by DVSIXDI except in the calculation of number of task switches.
  166.  
  167.  
  168. Last updated: August 11, 1991
  169.  
  170. ----------------------------------------------------------------------------
  171.  
  172. NAME
  173.      kill - Kill a DESQview process
  174.  
  175. SYNOPSIS
  176.      kill [/p /?] <process_id>
  177.  
  178. DESCRIPTION
  179.      KILL "kills" a DESQview process.  It works just like "Close Window"
  180.      except that it will kill the process even if the "Allow Close
  181.      Window Command" is "N" in the DVP file.  This command is dangerous,
  182.      because you could easily lose data if you don't save before
  183.      using kill.  It is much better to exit a program (especially
  184.      non-DESQview programs) from the program itself.
  185.  
  186.      The process to be killed is unswapped, brought to the top,
  187.      and killed.  Kill then displays the handle of the killed process.
  188.  
  189.      KILL requires DVSIXDI 1.1 to be installed.
  190.  
  191. OPTIONS
  192.      All options are case sensitive.
  193.  
  194.      /p
  195.      When the process is killed, print "Press any key to
  196.      continue..." and wait for a keystroke.
  197.  
  198.      /?
  199.      Print a help message summarizing the options.
  200.  
  201.      <process_id>
  202.      The process to be killed. If <process_id> is 4 digits, it is
  203.      interpreted as a hex DESQview process handle from PS.  If it is
  204.      less than 4 digits, it is interpreted as a Switch Windows number.
  205.  
  206. BUGS
  207.      Some programs are determined not to die. They may require a
  208.      keystroke to make them go.
  209.  
  210. Last Updated: August 1, 1991
  211.  
  212. ----------------------------------------------------------------------------
  213.  
  214. NAME
  215.      perf - DESQview CPU performance statistics
  216.  
  217. SYNOPSIS
  218.      perf [/cn /p /?]
  219.  
  220. DESCRIPTION
  221.      PERF displays DESQview's performance.  It requires DVSIXDI 1.1
  222.      to be installed.
  223.  
  224.      PERF's output looks like this:
  225.  
  226.                         INSTANT      TOTAL
  227.      CPU Utilization          5%        36%
  228.      Task Switches           10        500
  229.      Task Switches/s        1.0        1.5
  230.      Time (1/100 s)        1011      75067
  231.  
  232.      Two columns of information are presented.  The statistics in the
  233.      INSTANT column represent the performance averaged over approximately
  234.      the last 10 seconds, while the TOTAL column represents the performance
  235.      averaged over the entire time DESQview has been running.
  236.  
  237.      CPU Utilization
  238.      The percentage of time spent running programs other than the
  239.      DV System Task.
  240.  
  241.      Task Switches
  242.      Number of times that DESQview has switched to a different task.
  243.  
  244.      Task Switches/s
  245.      Number of task switches per second during the time period.
  246.  
  247.      Time
  248.      The amount of time in 1/100 seconds that was used to calculate
  249.      the statistics.  The INSTANT column may be at up to 10 seconds old.
  250.  
  251. OPTIONS
  252.      All options are case sensitive.  Options may be strung together:
  253.      /c4/p
  254.  
  255.      /cn
  256.      Continuously update the statistics every n seconds.  Normally, perf
  257.      lists the statistics and exits.  This option is most useful when
  258.      perf is used in its own window.  n must be an integer between
  259.      0 and 65535.  Hitting any key will stop the listing and
  260.      cause perf to exit.  A good value for n is 10 seconds, since
  261.      DVSIXDI updates the INSTANT information every 10 seconds.
  262.  
  263.      /p
  264.      When the listing is complete, print "Press any key to
  265.      continue..." and wait for a keystroke.  Helpful if you are
  266.      not using /c and you want to use perf in its own window.  Will
  267.      work with the /c option.
  268.  
  269.      /?
  270.      Prints a help screen.  If any bad options are given, this
  271.      screen will automatically be printed.
  272.  
  273. BUGS
  274.      Integer math is used for the calculations; truncation rather than
  275.      rounding occurs in the least significant digit.
  276.  
  277.      The INSTANT column gives strange numbers during the first 10 seconds
  278.      after DESQview is started.
  279.  
  280. Last Updated: August 5, 1991
  281.  
  282. ----------------------------------------------------------------------------
  283.  
  284. NAME
  285.      ps - DESQview process status
  286.  
  287. SYNOPSIS
  288.      ps [/cn /dpath /p /r /l /?] [<process_id>]
  289.  
  290. DESCRIPTION
  291.      PS provides information on the current DESQview processes.
  292.      It requires DVSIXDI 1.1 to be installed.  Without the /l option,
  293.      PS's output looks like this:
  294.  
  295.      HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPUTIME CPU UT KY NAME
  296.      d662 ?   0 95f6 641680 278512  276144  433516  89.2%    DV System Task
  297.      cf9b 1   1 0fe8  16464   1632    1088       0   0.0% CC Clock & Calendar
  298.      d027 2   1 1c34 ?????? Swappds ??????    6764   5.1% WP WordPerfect 5
  299.      cfe1 3   1 1b52 Swappd    592    1088     344   6.7% MF Quarterdeck Manifest
  300.  
  301.      The columns are described below:
  302.  
  303.      HNDL
  304.      The hexadecimal segment of the process's handle, similar to UNIX's PID.
  305.  
  306.      SW
  307.      The number appearing on the Switch Windows menu for this
  308.      task.  Applications which are "orphaned" and do not appear
  309.      on the Switch Windows menu, as well as the DV system task, will
  310.      contain a "?" in this column.
  311.  
  312.      TK
  313.      The number of separate tasks, including itself, that the
  314.      application has started.  For most programs, this will show
  315.      1, but some DESQview specific programs may use more than one
  316.      task.
  317.  
  318.      MAP
  319.      The hexadecimal mapping context of the application.  This number
  320.      is used with a DESQview API call to guarantee that the program
  321.      is in conventional memory.
  322.  
  323.      TTLMEM
  324.      The total memory, in bytes, used by the application.  If
  325.      "Swappd" appears in this column, the process's memory is
  326.      swapped out.  If system memory is swapped out, a "??????"
  327.      will appear in the field because the real value cannot be
  328.      determined.
  329.  
  330.      SYSMEM
  331.      The system memory, in bytes, used by the application. If
  332.      "Swappd" appears in this column, the process's system memory is
  333.      swapped out.  If an "s" is appended to the value, the system
  334.      memory resides in shared memory (see Wordperfect, above).
  335.  
  336.      L SYS
  337.      The largest block of system memory, in bytes, available to
  338.      the application. A "??????" implies that the value cannot be
  339.      determined.
  340.  
  341.      CPUTIME
  342.      Approximate amount CPU Time in 1/100 seconds for the process.
  343.      The time is actually only accurate to about 6/100 of a second.
  344.  
  345.      CPU UT
  346.      Approximate percentage of CPU time that the process has used in
  347.      the last approximately 10 seconds.  This column may be at most
  348.      10 seconds old.  The percentage for the DV System Task is
  349.      basically unused CPU time.
  350.  
  351.      KY
  352.      The keys used to open the application.
  353.  
  354.      NAME
  355.      The name of the application, as shown on the Open Window
  356.      menu.
  357.  
  358.      If the /l option is used, the output looks a little messier:
  359.  
  360.      HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPUTIME CPU UT KY NAME
  361.      kbd  mbx  obq  cursor  positn  visible logcl dispd
  362.  
  363.      d3e2  ?  0 0249 654016 384752  354128  723011  97.2%    DV System Task
  364.      014d d3e2 0197 ( 1,17) ( 0,56) ( 0, 0) 17x24 17x24
  365.  
  366.      ce55  ?  1 1044  16448   1632    1088       6   0.0% CC Clock & Calendar
  367.      014d ce55 0197 ( 0,33) (58,15) ( 0, 0)  1x45  1x35
  368.  
  369.      cefe  2  1 1aca 589808    480     432   55865   0.0% BD Big DOS
  370.      014d cefe 0197 (39, 6) ( 0, 0) ( 0, 0) 60x80 60x80
  371.  
  372.      cf4f  3  1 1fe0  32736    208     208   33714   2.8% PS DVSI ps
  373.      014d cf4f 0197 (16,15) (11, 0) ( 0, 0) 50x80 28x80
  374.  
  375.  
  376.      The additional columns in the second line for each process are:
  377.  
  378.      KBD MBX OBQ
  379.      The hex offsets for the process's default keyboard, mailbox and
  380.      objectq.  The segments are the same as the process's handle.
  381.  
  382.      CURSOR
  383.      The position of the cursor relative to the window's origin,
  384.      (row, column).
  385.  
  386.      POSITN
  387.      The upper left corner of the window on the screen, (row, column).
  388.  
  389.      VISIBLE
  390.      The coordinate of the upper left corner of the displayed window,
  391.      (row, column).  This number can be changed by using "Rearrange -
  392.      Scroll".
  393.  
  394.      LOGCL
  395.      Logical, or maximum, size of the window, in rows x columns.
  396.  
  397.      DISPD
  398.      Displayed size of the window, in rows x columns.
  399.  
  400. OPTIONS
  401.      All options are case sensitive.  Options may be strung together:
  402.      /c4/p/d\dv
  403.  
  404.      /cn
  405.      Continuously update the list every n seconds.  Normally, ps
  406.      lists the status and exits.  This option is most useful when
  407.      ps is used in its own window.  n must be an integer between
  408.      0 and 65535 (I don't know why you'd want to wait 18 hours,
  409.      but you can!).  Hitting any key will stop the listing and
  410.      cause ps to exit.
  411.  
  412.      /p
  413.      When the listing is complete, print "Press any key to
  414.      continue..." and wait for a keystroke.  Helpful if you are
  415.      not using /c and you want to use ps in its own window.  Will
  416.      work with the /c option.
  417.  
  418.      /dpath
  419.      Find DESQVIEW.DVO in the directory specified by path.
  420.      DESQVIEW.DVO is the file that the Open Window menu gets its
  421.      info from, and where ps finds the NAME and KEY fields.  If
  422.      this option is not specified, ps will first look in C:\DV, then
  423.      search the PATH environment variable for the directory.
  424.      This will usually work because the DESQview system directory
  425.      name should be in the PATH.  However, I have noticed that
  426.      the environment does  not get passed if ps is started from
  427.      its own window, so I provided this option.
  428.  
  429.      /r
  430.      Resize the window according to the number of processes in the list.
  431.      The window is made 80 columns wide and high enough for all the
  432.      processes to be displayed, and is moved left to column 0.
  433.      If using /c and the number of processes changes, the window size
  434.      is changed also.
  435.  
  436.      /l
  437.      Long listing: more info than you really wanted to know about each
  438.      process.
  439.  
  440.      /?
  441.      Prints a help screen.  If any bad options are given, this
  442.      screen will automatically be printed.
  443.  
  444.      <process_id>
  445.      If <process_id> is specified, only display info for that process.
  446.      Normally, PS displays all processes.  <process_id> is interpreted
  447.      as a hexadecimal handle if it is 4 digits.  Otherwise, it
  448.      is considered a switch windows number.
  449.  
  450. BUGS
  451.      Any processes started after 15 have been started will be ignored.
  452.  
  453.      Running Add A Program or Delete A Program no longer confuses
  454.      PS.  However, if you are using /c and you add or delete programs,
  455.      and run them, PS may display "(not available)" in the NAME
  456.      field.  This is because PS does not close and reopen DESQVIEW.DVO
  457.      each iteration.  If the "(not available)" bothers you, exit
  458.      PS and restart.
  459.  
  460.  
  461. Last Updated: August 11, 1991
  462.  
  463.  
  464. ----------------------------------------------------------------------------
  465.  
  466. NAME
  467.      memstat - DESQview memory status
  468.  
  469. SYNOPSIS
  470.      memstat [/cn /p /?]
  471.  
  472. DESCRIPTION
  473.      MEMSTAT is an alternative to DESQview's Memory Status program.
  474.      It takes up much less CPU time, although it is larger than
  475.      Memory Status.  It can also be used at the DOS command line,
  476.      while Memory Status cannot.
  477.  
  478.      MEMSTAT displays the same information as memory status, and
  479.      adds another column.  The output looks like this:
  480.  
  481.      TYPE  TOTAL LARGEST AVAILABLE USED
  482.      Conv   590K    345K      375K  36%
  483.      Exp   2912K    576K     1184K  59%
  484.      Com  25600   10668     10804   58%
  485.  
  486.      The columns are:
  487.  
  488.      TYPE
  489.      The type of memory described in this row.  "Conv" is conventional
  490.      memory, or memory between 0 and 640K.  "Exp" is expanded
  491.      (EMS or EEMS) memory.  "Com" is DESQview's common memory
  492.      area.
  493.  
  494.      TOTAL
  495.      The total amount of memory in the system.
  496.  
  497.      LARGEST
  498.      The largest block of available memory.
  499.  
  500.      AVAILABLE
  501.      The total amount of memory currently available.
  502.  
  503.      USED
  504.      The percentage of memory that is currently being used.
  505.  
  506. OPTIONS
  507.      All options are case sensitive.  Options may be strung together:
  508.      /c4/p
  509.  
  510.      /cn
  511.      Continuously update the statistics every n seconds.  Normally, memstat
  512.      lists the statistics and exits.  This option is most useful when
  513.      memstat is used in its own window.  n must be an integer between
  514.      0 and 65535.  Hitting any key will stop the listing and
  515.      cause memstat to exit.
  516.  
  517.      /p
  518.      When the listing is complete, print "Press any key to
  519.      continue..." and wait for a keystroke.  Helpful if you are
  520.      not using /c and you want to use perf in its own window.  Will
  521.      work with the /c option.
  522.  
  523.      /?
  524.      Prints a help screen.  If any bad options are given, this
  525.      screen will automatically be printed.
  526.  
  527. Last Updated: August 11, 1991
  528.  
  529. --------------------------------------------------------------------------
  530.  
  531. NAME
  532.      uptime - Print amount of time DESQview has been running
  533.  
  534. SYNOPSIS
  535.      uptime [/p /?]
  536.  
  537. DESCRIPTION
  538.      UPTIME reports the amount of time that DESQview has been running
  539.      in the following format:
  540.  
  541.      DESQview has been running for 2 days 1 hour 5 minutes and 21.34 seconds
  542.      Since Fri Aug 02 18:23:45 1991
  543.  
  544.      UPTIME requires DVSIXDI 1.1 to be installed.
  545.  
  546. OPTIONS
  547.      All options are case sensitive.
  548.  
  549.      /p
  550.      After the time is displayed, print "Press any key to
  551.      continue..." and wait for a keystroke.
  552.  
  553.      /?
  554.      Print a help message summarizing the options.
  555.  
  556.  
  557. Last Updated: August 2, 1991
  558.  
  559. --------------------------------------------------------------------------
  560.  
  561. NAME
  562.      wn - Manipulate DESQview windows
  563.  
  564. SYNOPSIS
  565.      wn [/?] <command> [<process_id>]
  566.  
  567. DESCRIPTION
  568.      WN contains a set of commands for manipulating DESQview windows.
  569.      Windows may be killed, raised, lowered, topped, hidden or
  570.      suspended.
  571.  
  572.      Killing a window is just like the DVSI's KILL command.  Read
  573.      KILL's man page for more information.
  574.  
  575.      Raising a window gives it the keyboard.  It is equivalent to
  576.      using the "Switch Windows" menu.
  577.  
  578.      Lowering a window puts it at the bottom of the window stack,
  579.      and takes away the keyboard.
  580.  
  581.      Topping a window brings it to the top of the window stack, but
  582.      does not give it the keyboard.
  583.  
  584.      Hidding a window is works just like "Rearrange - Hide".
  585.  
  586.      Suspending a window hides it and doesn't give it any CPU time
  587.      while hidden.
  588.  
  589.      A suspended or hidden window may be unhidden by raising or
  590.      topping it.
  591.  
  592. OPTIONS
  593.  
  594.      /?
  595.      Print a help message
  596.  
  597.      <command> may be one of the following.  The first letter of the
  598.      command may be used as an abbreviation.  The command is
  599.      case-insensitive.
  600.      KILL
  601.      RAISE
  602.      LOWER
  603.      TOP
  604.      HIDE
  605.      SUSPEND
  606.  
  607.      If <process_id> is specified, that process's window is manipulated.
  608.      Otherwise, the current process's window is used.  If <process_id>
  609.      is 4 hex digits, it is interpreted as a handle.  Otherwise,
  610.      it is considered a Switch Windows number.
  611.  
  612. Last Updated: August 11, 1991
  613.